Skip to content

Feat: Slack docs search sub command with JSON output#383

Draft
lukegalbraithrussell wants to merge 8 commits intomainfrom
docs-search-integration
Draft

Feat: Slack docs search sub command with JSON output#383
lukegalbraithrussell wants to merge 8 commits intomainfrom
docs-search-integration

Conversation

@lukegalbraithrussell
Copy link
Contributor

@lukegalbraithrussell lukegalbraithrussell commented Mar 10, 2026

Changelog

Working commands:

command result
slack docs search Opens search page in browser when no query provided
slack docs search "webhooks" Search and open results in terminal as json (so default is --output=json)
slack docs search "webhooks" --filter=python --limit=5 JSON with filters and limits
slack docs search "webhooks" --output=browser. Opens search page in browser

Summary

(Please describe the goal of this pull request and mention any related issue numbers)

Requirements

- Add internal/search package with pure Go search implementation
- Enhance docs command with --output flag (browser|json)
- Support searching 1000+ markdown files with ~500ms performance
- Browser behavior unchanged (default), JSON output for LLMs/automation
- Smart relevance scoring and contextual snippets around search terms
- Auto-discovery of docs repository for seamless integration

Made-with: Cursor
- Remove trailing whitespace
- Fix spacing around comments and assignments
- Add final newlines to files

Made-with: Cursor
- Add --limit flag to control number of results (default: 20)
- Add --offset flag for pagination (skip N results)
- Include pagination metadata in JSON response
- Support page navigation with has_next/has_previous indicators
- Update help examples to demonstrate pagination usage
- Enables LLMs to access all search results, not just first 20

Made-with: Cursor
@lukegalbraithrussell lukegalbraithrussell changed the title Feat: adds output=json flag to slack docs Feat: Slack docs search sub command with JSON output Mar 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant